IRIX Base Documentation 1998 November

home *** CD-ROM | disk | FTP | other *** search

/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / p_man / cat3 / Xm / XmSimpleSpinBox.z / XmSimpleSpinBox

Wrap

Text File | 1998-10-30 | 45KB | 463 lines

XXXXmmmmSSSSiiiimmmmpppplllleeeeSSSSppppiiiinnnnBBBBooooxxxx((((lllliiiibbbbrrrraaaarrrryyyy ccccaaaallllUUUUllllNNNN))))IIIIXXXX SSSSyyyysssstttteeeemmmmXXXXmmmmVVVVSSSSiiiimmmmpppplllleeeeSSSSppppiiiinnnnBBBBooooxxxx((((lllliiiibbbbrrrraaaarrrryyyy ccccaaaallllllll)))) NNNNAAAAMMMMEEEE XXXXmmmmSSSSiiiimmmmpppplllleeeeSSSSppppiiiinnnnBBBBooooxxxx - a simple SpinBox widget class SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS #include <Xm/SSpinB.h> DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN The XmSimpleSpinBox widget is a user interface control to increment and decrement an arbitrary TextField. For example, it can be used to cycle through the months of the year or days of the month. Widget subclassing is not supported for the XmSimpleSpinBox widget class. CCCCllllaaaasssssssseeeessss The XmSimpleSpinBox widget inherits behavior and resources from the CCCCoooorrrreeee, CCCCoooommmmppppoooossssiiiitttteeee and XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr classes. The class pointer is _X_m_S_i_m_p_l_e_S_p_i_n_B_o_x_W_i_d_g_e_t_C_l_a_s_s. The class name is XXXXmmmmSSSSiiiimmmmpppplllleeeeSSSSppppiiiinnnnBBBBooooxxxxWWWWiiiiddddggggeeeetttt. NNNNeeeewwww RRRReeeessssoooouuuurrrrcccceeeessss The following table defines a set of widget resources used by the application to specify data. The application can also set the resource values for the inherited classes to set attributes for this widget. To reference a resource by name or by class in a ....XXXXddddeeeeffffaaaauuuullllttttssss file, the application must remove the _X_m_N or _X_m_C prefix and use the remaining letters. To specify one of the defined values for a resource in a ....XXXXddddeeeeffffaaaauuuullllttttssss file, the application must remove the XXXXmmmm prefix and use the remaining letters (in either lower case or upper case, but including any underscores between words). The codes in the access column indicate if the given resource can be set at creation time (C), set by using XXXXttttSSSSeeeettttVVVVaaaalllluuuueeeessss (S), retrieved by using XXXXttttGGGGeeeettttVVVVaaaalllluuuueeeessss (G), or is not applicable (N/A). XXXXmmmmSSSSiiiimmmmpppplllleeeeSSSSppppiiiinnnnBBBBooooxxxx RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt NNNNaaaammmmeeee CCCCllllaaaassssssss TTTTyyyyppppeeee DDDDeeeeffffaaaauuuulllltttt AAAAcccccccceeeessssssss XXXXmmmmNNNNaaaarrrrrrrroooowwwwLLLLaaaayyyyoooouuuutttt XXXXmmmmCCCCAAAArrrrrrrroooowwwwLLLLaaaayyyyoooouuuutttt uuuunnnnssssiiiiggggnnnneeeedddd cccchhhhaaaarrrr XmARROWS_END CSG XXXXmmmmNNNNaaaarrrrrrrroooowwwwSSSSeeeennnnssssiiiittttiiiivvvviiiittttyyyy XXXXmmmmCCCCAAAArrrrrrrroooowwwwSSSSeeeennnnssssiiiittttiiiivvvviiiittttyyyy uuuunnnnssssiiiiggggnnnneeeedddd cccchhhhaaaarrrr XmARROWS-_SENSITIVE CSG XXXXmmmmNNNNccccoooolllluuuummmmnnnnssss XXXXmmmmCCCCCCCCoooolllluuuummmmnnnn sssshhhhoooorrrrtttt 20 CSG XXXXmmmmNNNNddddeeeecccciiiimmmmaaaallllPPPPooooiiiinnnnttttssss XXXXmmmmCCCCDDDDeeeecccciiiimmmmaaaallllPPPPooooiiiinnnnttttssss sssshhhhoooorrrrtttt 0 CSG XXXXmmmmNNNNeeeeddddiiiittttaaaabbbblllleeee XXXXmmmmCCCCEEEEddddiiiittttaaaabbbblllleeee BBBBoooooooolllleeeeaaaannnn True CSG XXXXmmmmNNNNiiiinnnnccccrrrreeeemmmmeeeennnnttttVVVVaaaalllluuuueeee XXXXmmmmCCCCIIIInnnnccccrrrreeeemmmmeeeennnnttttVVVVaaaalllluuuueeee iiiinnnntttt 1 CSG XXXXmmmmNNNNiiiinnnniiiittttiiiiaaaallllDDDDeeeellllaaaayyyy XXXXmmmmCCCCIIIInnnniiiittttiiiiaaaallllDDDDeeeellllaaaayyyy uuuunnnnssssiiiiggggnnnneeeedddd iiiinnnntttt 250 CSG XXXXmmmmNNNNmmmmaaaaxxxxiiiimmmmuuuummmmVVVVaaaalllluuuueeee XXXXmmmmCCCCMMMMaaaaxxxxiiiimmmmuuuummmmVVVVaaaalllluuuueeee iiiinnnntttt 10 CSG XXXXmmmmNNNNmmmmiiiinnnniiiimmmmuuuummmmVVVVaaaalllluuuueeee XXXXmmmmCCCCMMMMiiiinnnniiiimmmmuuuummmmVVVVaaaalllluuuueeee iiiinnnntttt 0 CSG Page 1 (printed 10/24/98) XXXXmmmmSSSSiiiimmmmpppplllleeeeSSSSppppiiiinnnnBBBBooooxxxx((((lllliiiibbbbrrrraaaarrrryyyy ccccaaaallllUUUUllllNNNN))))IIIIXXXX SSSSyyyysssstttteeeemmmmXXXXmmmmVVVVSSSSiiiimmmmpppplllleeeeSSSSppppiiiinnnnBBBBooooxxxx((((lllliiiibbbbrrrraaaarrrryyyy ccccaaaallllllll)))) XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk XXXXmmmmCCCCCCCCaaaallllllllbbbbaaaacccckkkk XXXXttttCCCCaaaallllllllbbbbaaaacccckkkkLLLLiiiisssstttt NULL C XXXXmmmmNNNNnnnnuuuummmmVVVVaaaalllluuuueeeessss XXXXmmmmCCCCNNNNuuuummmmVVVVaaaalllluuuueeeessss iiiinnnntttt 0 CSG XXXXmmmmNNNNppppoooossssiiiittttiiiioooonnnn XXXXmmmmCCCCPPPPoooossssiiiittttiiiioooonnnn iiiinnnntttt 0 CSG XXXXmmmmNNNNrrrreeeeppppeeeeaaaattttDDDDeeeellllaaaayyyy XXXXmmmmCCCCRRRReeeeppppeeeeaaaattttDDDDeeeellllaaaayyyy uuuunnnnssssiiiiggggnnnneeeedddd iiiinnnntttt 200 CSG XXXXmmmmNNNNssssppppiiiinnnnBBBBooooxxxxCCCChhhhiiiillllddddTTTTyyyyppppeeee XXXXmmmmCCCCSSSSppppiiiinnnnBBBBooooxxxxCCCChhhhiiiillllddddTTTTyyyyppppeeee uuuunnnnssssiiiiggggnnnneeeedddd cccchhhhaaaarrrr XmSTRING CG XXXXmmmmNNNNtttteeeexxxxttttFFFFiiiieeeelllldddd XXXXmmmmCCCCTTTTeeeexxxxttttFFFFiiiieeeelllldddd WWWWiiiiddddggggeeeetttt dynamic G XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk XXXXmmmmCCCCCCCCaaaallllllllbbbbaaaacccckkkk XXXXttttCCCCaaaallllllllbbbbaaaacccckkkkLLLLiiiisssstttt NULL C XXXXmmmmNNNNvvvvaaaalllluuuueeeessss XXXXmmmmCCCCVVVVaaaalllluuuueeeessss XXXXmmmmSSSSttttrrrriiiinnnnggggTTTTaaaabbbblllleeee NULL CSG XXXXmmmmNNNNaaaarrrrrrrroooowwwwLLLLaaaayyyyoooouuuutttt Specifies the style and position of the SpinBox arrows. The following values are supported: XmARROWS_FLAT_BEGINNING The arrows are placed side by side to the right of the TextField. XmARROWS_FLAT_END The arrows are placed side by side to the left of the TextField. XmARROWS_SPLIT The down arrow is on the left and the up arrow is on the right of the TextField. XmARROWS_BEGINNING The arrows are stacked and placed on the left of the TextField. XmARROWS_END The arrows are stacked and placed on the right of the TextField. XXXXmmmmNNNNaaaarrrrrrrroooowwwwSSSSeeeennnnssssiiiittttiiiivvvviiiittttyyyy Specifies the sensitivity of the arrows in the XmSimpleSpinBox. The following values are supported: XmARROWS_SENSITIVE Both arrows are active to user selection. XmARROWS_DECREMENT_SENSITIVE The down arrow is active and the up arrow is inactive to user selection. XmARROWS_INCREMENT_SENSITIVE The up arrow is active and the down arrow is inactive to user selection. XmARROWS_INSENSITIVE Both arrows are inactive to user Page 2 (printed 10/24/98) XXXXmmmmSSSSiiiimmmmpppplllleeeeSSSSppppiiiinnnnBBBBooooxxxx((((lllliiiibbbbrrrraaaarrrryyyy ccccaaaallllUUUUllllNNNN))))IIIIXXXX SSSSyyyysssstttteeeemmmmXXXXmmmmVVVVSSSSiiiimmmmpppplllleeeeSSSSppppiiiinnnnBBBBooooxxxx((((lllliiiibbbbrrrraaaarrrryyyy ccccaaaallllllll)))) selection. XXXXmmmmNNNNccccoooolllluuuummmmnnnnssss Specifies the number of columns of the text field. XXXXmmmmNNNNddddeeeecccciiiimmmmaaaallllPPPPooooiiiinnnnttttssss Specifies the position of the radix character within the numeric value when XXXXmmmmNNNNssssppppiiiinnnnBBBBooooxxxxCCCChhhhiiiillllddddTTTTyyyyppppeeee is XXXXmmmmNNNNUUUUMMMMEEEERRRRIIIICCCC. This resource is used to allow for floating point values in the XmSimpleSpinBox widget. XXXXmmmmNNNNeeeeddddiiiittttaaaabbbblllleeee Specifies whether the text field can take input. When XXXXmmmmNNNNeeeeddddiiiittttaaaabbbblllleeee is used on a widget it sets the dropsite to XXXXmmmmDDDDRRRROOOOPPPP____SSSSIIIITTTTEEEE____AAAACCCCTTTTIIIIVVVVEEEE. XXXXmmmmNNNNiiiinnnnccccrrrreeeemmmmeeeennnnttttVVVVaaaalllluuuueeee Specifies the amount to increment or decrement the XXXXmmmmNNNNppppoooossssiiiittttiiiioooonnnn when the XXXXmmmmNNNNssssppppiiiinnnnBBBBooooxxxxCCCChhhhiiiillllddddTTTTyyyyppppeeee is XXXXmmmmNNNNUUUUMMMMEEEERRRRIIIICCCC. When the Up action is activated, the XXXXmmmmNNNNiiiinnnnccccrrrreeeemmmmeeeennnnttttVVVVaaaalllluuuueeee is added to the XXXXmmmmNNNNppppoooossssiiiittttiiiioooonnnnvalue; when the Down action is activated, the XXXXmmmmNNNNiiiinnnnccccrrrreeeemmmmeeeennnnttttVVVVaaaalllluuuueeee is subtracted from the XXXXmmmmNNNNppppoooossssiiiittttiiiioooonnnn value. When XXXXmmmmNNNNssssppppiiiinnnnBBBBooooxxxxCCCChhhhiiiillllddddTTTTyyyyppppeeee is XXXXmmmmSSSSTTTTRRRRIIIINNNNGGGG, this resource is ignored. XXXXmmmmNNNNiiiinnnniiiittttiiiiaaaallllDDDDeeeellllaaaayyyy Specifies the amount of time in milliseconds before the Arrow buttons will begin to spin continuously. XXXXmmmmNNNNnnnnuuuummmmVVVVaaaalllluuuueeeessss Specifies the number of items in the XXXXmmmmNNNNvvvvaaaalllluuuueeeessss list when the XXXXmmmmNNNNssssppppiiiinnnnBBBBooooxxxxCCCChhhhiiiillllddddTTTTyyyyppppeeee resource is XXXXmmmmSSSSTTTTRRRRIIIINNNNGGGG. The value of this resource must be a positive integer. The XXXXmmmmNNNNnnnnuuuummmmVVVVaaaalllluuuueeeessss is maintained by the XmSimpleSpinBox widget when items are added or deleted from the XXXXmmmmNNNNvvvvaaaalllluuuueeeesssslist. When XXXXmmmmNNNNssssppppiiiinnnnBBBBooooxxxxCCCChhhhiiiillllddddTTTTyyyyppppeeee is not XXXXmmmmSSSSTTTTRRRRIIIINNNNGGGG, this resource is ignored. XXXXmmmmNNNNvvvvaaaalllluuuueeeessss Supplies the list of strings to cycle through when the _X_m_N_s_p_i_n_B_u_t_t_o_n_C_h_i_l_d_T_y_p_e resource is XXXXmmmmSSSSTTTTRRRRIIIINNNNGGGG. When XXXXmmmmNNNNssssppppiiiinnnnBBBBooooxxxxCCCChhhhiiiillllddddTTTTyyyyppppeeee is not XXXXmmmmSSSSTTTTRRRRIIIINNNNGGGG, this resource is ignored. XXXXmmmmNNNNmmmmaaaaxxxxiiiimmmmuuuummmmVVVVaaaalllluuuueeee Specifies the upper bound on the XmSimpleSpinBox's range when XXXXmmmmNNNNssssppppiiiinnnnBBBBooooxxxxCCCChhhhiiiillllddddTTTTyyyyppppeeee is XXXXmmmmNNNNUUUUMMMMEEEERRRRIIIICCCC. Page 3 (printed 10/24/98) XXXXmmmmSSSSiiiimmmmpppplllleeeeSSSSppppiiiinnnnBBBBooooxxxx((((lllliiiibbbbrrrraaaarrrryyyy ccccaaaallllUUUUllllNNNN))))IIIIXXXX SSSSyyyysssstttteeeemmmmXXXXmmmmVVVVSSSSiiiimmmmpppplllleeeeSSSSppppiiiinnnnBBBBooooxxxx((((lllliiiibbbbrrrraaaarrrryyyy ccccaaaallllllll)))) XXXXmmmmNNNNmmmmiiiinnnniiiimmmmuuuummmmVVVVaaaalllluuuueeee Specifies the lower bound on the XmSimpleSpinBox's range when XXXXmmmmNNNNssssppppiiiinnnnBBBBooooxxxxCCCChhhhiiiillllddddTTTTyyyyppppeeee is XXXXmmmmNNNNUUUUMMMMEEEERRRRIIIICCCC. XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk Specifies the callback to be invoked just before the XmSimpleSpinBox position changes. The application can use this callback to implement new application-related logic (including setting new position spinning to, or canceling the impending action). For example, this callback can be used to stop the spinning just before wrapping at the upper and lower position boundaries. If the application sets the _d_o_i_t member of the XXXXmmmmSSSSiiiimmmmpppplllleeeeSSSSppppiiiinnnnBBBBooooxxxxCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt to False, nothing happens. Otherwise, the position changes. Reasons sent by the callback are XXXXmmmmCCCCRRRR____SSSSPPPPIIIINNNN____NNNNEEEEXXXXTTTT, or XXXXmmmmCCCCRRRR____SSSSPPPPIIIINNNN____PPPPRRRRIIIIOOOORRRR. XXXXmmmmNNNNppppoooossssiiiittttiiiioooonnnn The XXXXmmmmNNNNppppoooossssiiiittttiiiioooonnnn resource has a different value based on the XXXXmmmmNNNNssssppppiiiinnnnBBBBooooxxxxCCCChhhhiiiillllddddTTTTyyyyppppeeee resource. When XXXXmmmmNNNNssssppppiiiinnnnBBBBooooxxxxCCCChhhhiiiillllddddTTTTyyyyppppeeee is XXXXmmmmSSSSTTTTRRRRIIIINNNNGGGG, the XXXXmmmmNNNNppppoooossssiiiittttiiiioooonnnn is the index into the XXXXmmmmNNNNvvvvaaaalllluuuueeeessss list for the current item. When the XXXXmmmmNNNNssssppppiiiinnnnBBBBooooxxxxCCCChhhhiiiillllddddTTTTyyyyppppeeee resource is XXXXmmmmNNNNUUUUMMMMEEEERRRRIIIICCCC, the XXXXmmmmNNNNppppoooossssiiiittttiiiioooonnnn is the integer value of the XmSimpleSpinBox that falls within the range of XXXXmmmmNNNNmmmmaaaaxxxxiiiimmmmuuuummmmVVVVaaaalllluuuueeeeand XXXXmmmmNNNNmmmmiiiinnnniiiimmmmuuuummmmVVVVaaaalllluuuueeee. XXXXmmmmNNNNrrrreeeeppppeeeeaaaattttDDDDeeeellllaaaayyyy Specifies the number of milliseconds between repeated calls to the XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk while the user is spinning the XmSimpleSpinBox. XXXXmmmmNNNNssssppppiiiinnnnBBBBooooxxxxCCCChhhhiiiillllddddTTTTyyyyppppeeee Specifies the style of the XmSimpleSpinBox. The following values are supported: XmSTRING The child is a string value that is specified through the XXXXmmmmNNNNvvvvaaaalllluuuueeeessss resource and incremented and decremented by changing the XXXXmmmmNNNNppppoooossssiiiittttiiiioooonnnn resource. XmNUMERIC The child is a numeric value that is specified through the XXXXmmmmNNNNppppoooossssiiiittttiiiioooonnnn resource and incremented according to the XXXXmmmmNNNNiiiinnnnccccrrrreeeemmmmeeeennnnttttVVVVaaaalllluuuueeee resource. XXXXmmmmtttteeeexxxxttttFFFFiiiieeeelllldddd Specifies the textfield widget. Page 4 (printed 10/24/98) XXXXmmmmSSSSiiiimmmmpppplllleeeeSSSSppppiiiinnnnBBBBooooxxxx((((lllliiiibbbbrrrraaaarrrryyyy ccccaaaallllUUUUllllNNNN))))IIIIXXXX SSSSyyyysssstttteeeemmmmXXXXmmmmVVVVSSSSiiiimmmmpppplllleeeeSSSSppppiiiinnnnBBBBooooxxxx((((lllliiiibbbbrrrraaaarrrryyyy ccccaaaallllllll)))) XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk Specifies the callback to be invoked whenever the value of the XXXXmmmmNNNNppppoooossssiiiittttiiiioooonnnn resource is changed through the use of the spinner arrows. The XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk passes the XXXXmmmmSSSSiiiimmmmpppplllleeeeSSSSppppiiiinnnnBBBBooooxxxxCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt _c_a_l_l__d_a_t_a structure. IIIInnnnhhhheeeerrrriiiitttteeeedddd RRRReeeessssoooouuuurrrrcccceeeessss The XmSimpleSpinBox widget inherits behavior and resources from the following named superclasses. For a complete description of each resource, see the man page entry in for that superclass. XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt NNNNaaaammmmeeee CCCCllllaaaassssssss TTTTyyyyppppeeee DDDDeeeeffffaaaauuuulllltttt AAAAcccccccceeeessssssss XXXXmmmmNNNNbbbboooottttttttoooommmmSSSShhhhaaaaddddoooowwwwCCCCoooolllloooorrrr XXXXmmmmCCCCBBBBoooottttttttoooommmmSSSShhhhaaaaddddoooowwwwCCCCoooolllloooorrrr PPPPiiiixxxxeeeellll dynamic CSG XXXXmmmmNNNNbbbboooottttttttoooommmmSSSShhhhaaaaddddoooowwwwPPPPiiiixxxxmmmmaaaapppp XXXXmmmmCCCCBBBBoooottttttttoooommmmSSSShhhhaaaaddddoooowwwwPPPPiiiixxxxmmmmaaaapppp PPPPiiiixxxxmmmmaaaapppp XXXXmmmmUUUUNNNNSSSSPPPPEEEECCCCIIIIFFFFIIIIEEEEDDDD____PPPPIIIIXXXXMMMMAAAAPPPP CSG XXXXmmmmNNNNffffoooorrrreeeeggggrrrroooouuuunnnndddd XXXXmmmmCCCCFFFFoooorrrreeeeggggrrrroooouuuunnnndddd PPPPiiiixxxxeeeellll dynamic CSG XXXXmmmmNNNNhhhheeeellllppppCCCCaaaallllllllbbbbaaaacccckkkk XXXXmmmmCCCCCCCCaaaallllllllbbbbaaaacccckkkk XXXXttttCCCCaaaallllllllbbbbaaaacccckkkkLLLLiiiisssstttt NULL C XXXXmmmmNNNNhhhhiiiigggghhhhlllliiiigggghhhhttttCCCCoooolllloooorrrr XXXXmmmmCCCCHHHHiiiigggghhhhlllliiiigggghhhhttttCCCCoooolllloooorrrr PPPPiiiixxxxeeeellll dynamic CSG XXXXmmmmNNNNhhhhiiiigggghhhhlllliiiigggghhhhttttPPPPiiiixxxxmmmmaaaapppp XXXXmmmmCCCCHHHHiiiigggghhhhlllliiiigggghhhhttttPPPPiiiixxxxmmmmaaaapppp PPPPiiiixxxxmmmmaaaapppp dynamic CSG XXXXmmmmNNNNiiiinnnniiiittttiiiiaaaallllFFFFooooccccuuuussss XXXXmmmmCCCCIIIInnnniiiittttiiiiaaaallllFFFFooooccccuuuussss WWWWiiiiddddggggeeeetttt NULL CSG XXXXmmmmNNNNnnnnaaaavvvviiiiggggaaaattttiiiioooonnnnTTTTyyyyppppeeee XXXXmmmmCCCCNNNNaaaavvvviiiiggggaaaattttiiiioooonnnnTTTTyyyyppppeeee XXXXmmmmNNNNaaaavvvviiiiggggaaaattttiiiioooonnnnTTTTyyyyppppeeee dynamic CSG XXXXmmmmNNNNsssshhhhaaaaddddoooowwwwTTTThhhhiiiicccckkkknnnneeeessssssss XXXXmmmmCCCCSSSShhhhaaaaddddoooowwwwTTTThhhhiiiicccckkkknnnneeeessssssss DDDDiiiimmmmeeeennnnssssiiiioooonnnn dynamic CSG XXXXmmmmNNNNssssttttrrrriiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn XXXXmmmmCCCCSSSSttttrrrriiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn XXXXmmmmSSSSttttrrrriiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn dynamic CG XXXXmmmmNNNNttttooooppppSSSShhhhaaaaddddoooowwwwCCCCoooolllloooorrrr XXXXmmmmCCCCTTTTooooppppSSSShhhhaaaaddddoooowwwwCCCCoooolllloooorrrr PPPPiiiixxxxeeeellll dynamic CSG XXXXmmmmNNNNttttooooppppSSSShhhhaaaaddddoooowwwwPPPPiiiixxxxmmmmaaaapppp XXXXmmmmCCCCTTTTooooppppSSSShhhhaaaaddddoooowwwwPPPPiiiixxxxmmmmaaaapppp PPPPiiiixxxxmmmmaaaapppp dynamic CSG XXXXmmmmNNNNttttrrrraaaavvvveeeerrrrssssaaaallllOOOOnnnn XXXXmmmmCCCCTTTTrrrraaaavvvveeeerrrrssssaaaallllOOOOnnnn BBBBoooooooolllleeeeaaaannnn dynamic CSG XXXXmmmmNNNNuuuunnnniiiittttTTTTyyyyppppeeee XXXXmmmmCCCCUUUUnnnniiiittttTTTTyyyyppppeeee uuuunnnnssssiiiiggggnnnneeeedddd cccchhhhaaaarrrr dynamic CSG XXXXmmmmNNNNuuuusssseeeerrrrDDDDaaaattttaaaa XXXXmmmmCCCCUUUUsssseeeerrrrDDDDaaaattttaaaa XXXXttttPPPPooooiiiinnnntttteeeerrrr NULL CSG CCCCoooommmmppppoooossssiiiitttteeee RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt NNNNaaaammmmeeee CCCCllllaaaassssssss TTTTyyyyppppeeee DDDDeeeeffffaaaauuuulllltttt AAAAcccccccceeeessssssss XXXXmmmmNNNNcccchhhhiiiillllddddrrrreeeennnn XXXXmmmmCCCCRRRReeeeaaaaddddOOOOnnnnllllyyyy WWWWiiiiddddggggeeeettttLLLLiiiisssstttt NULL G XXXXmmmmNNNNiiiinnnnsssseeeerrrrttttPPPPoooossssiiiittttiiiioooonnnn XXXXmmmmCCCCIIIInnnnsssseeeerrrrttttPPPPoooossssiiiittttiiiioooonnnn XXXXttttOOOOrrrrddddeeeerrrrPPPPrrrroooocccc default procedure CSG XXXXmmmmNNNNnnnnuuuummmmCCCChhhhiiiillllddddrrrreeeennnn XXXXmmmmCCCCRRRReeeeaaaaddddOOOOnnnnllllyyyy CCCCaaaarrrrddddiiiinnnnaaaallll 0 G CCCCoooorrrreeee RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt NNNNaaaammmmeeee CCCCllllaaaassssssss TTTTyyyyppppeeee DDDDeeeeffffaaaauuuulllltttt AAAAcccccccceeeessssssss XXXXmmmmNNNNaaaacccccccceeeelllleeeerrrraaaattttoooorrrrssss XXXXmmmmCCCCAAAAcccccccceeeelllleeeerrrraaaattttoooorrrrssss XXXXttttAAAAcccccccceeeelllleeeerrrraaaattttoooorrrrssss dynamic CSG XXXXmmmmNNNNaaaannnncccceeeessssttttoooorrrrSSSSeeeennnnssssiiiittttiiiivvvveeee XXXXmmmmCCCCSSSSeeeennnnssssiiiittttiiiivvvveeee BBBBoooooooolllleeeeaaaannnn dynamic G XXXXmmmmNNNNbbbbaaaacccckkkkggggrrrroooouuuunnnndddd XXXXmmmmCCCCBBBBaaaacccckkkkggggrrrroooouuuunnnndddd PPPPiiiixxxxeeeellll dynamic CSG XXXXmmmmNNNNbbbbaaaacccckkkkggggrrrroooouuuunnnnddddPPPPiiiixxxxmmmmaaaapppp XXXXmmmmCCCCPPPPiiiixxxxmmmmaaaapppp PPPPiiiixxxxmmmmaaaapppp XXXXmmmmUUUUNNNNSSSSPPPPEEEECCCCIIIIFFFFIIIIEEEEDDDD____PPPPIIIIXXXXMMMMAAAAPPPP CSG XXXXmmmmNNNNbbbboooorrrrddddeeeerrrrCCCCoooolllloooorrrr XXXXmmmmCCCCBBBBoooorrrrddddeeeerrrrCCCCoooolllloooorrrr PPPPiiiixxxxeeeellll XtDefaultForeground CSG XXXXmmmmNNNNbbbboooorrrrddddeeeerrrrPPPPiiiixxxxmmmmaaaapppp XXXXmmmmCCCCPPPPiiiixxxxmmmmaaaapppp PPPPiiiixxxxmmmmaaaapppp XXXXmmmmUUUUNNNNSSSSPPPPEEEECCCCIIIIFFFFIIIIEEEEDDDD____PPPPIIIIXXXXMMMMAAAAPPPP CSG XXXXmmmmNNNNbbbboooorrrrddddeeeerrrrWWWWiiiiddddtttthhhh XXXXmmmmCCCCBBBBoooorrrrddddeeeerrrrWWWWiiiiddddtttthhhh DDDDiiiimmmmeeeennnnssssiiiioooonnnn 0 CSG XXXXmmmmNNNNccccoooolllloooorrrrmmmmaaaapppp XXXXmmmmCCCCCCCCoooolllloooorrrrmmmmaaaapppp CCCCoooolllloooorrrrmmmmaaaapppp dynamic CG XXXXmmmmNNNNddddeeeepppptttthhhh XXXXmmmmCCCCDDDDeeeepppptttthhhh iiiinnnntttt dynamic CG XXXXmmmmNNNNddddeeeessssttttrrrrooooyyyyCCCCaaaallllllllbbbbaaaacccckkkk XXXXmmmmCCCCCCCCaaaallllllllbbbbaaaacccckkkk XXXXttttCCCCaaaallllllllbbbbaaaacccckkkkLLLLiiiisssstttt NULL C XXXXmmmmNNNNhhhheeeeiiiigggghhhhtttt XXXXmmmmCCCCHHHHeeeeiiiigggghhhhtttt DDDDiiiimmmmeeeennnnssssiiiioooonnnn dynamic CSG XXXXmmmmNNNNiiiinnnniiiittttiiiiaaaallllRRRReeeessssoooouuuurrrrcccceeeessssPPPPeeeerrrrssssiiiisssstttteeeennnntttt XXXXmmmmCCCCIIIInnnniiiittttiiiiaaaallllRRRReeeessssoooouuuurrrrcccceeeessssPPPPeeeerrrrssssiiiisssstttteeeennnntttt BBBBoooooooolllleeeeaaaannnn True C Page 5 (printed 10/24/98) XXXXmmmmSSSSiiiimmmmpppplllleeeeSSSSppppiiiinnnnBBBBooooxxxx((((lllliiiibbbbrrrraaaarrrryyyy ccccaaaallllUUUUllllNNNN))))IIIIXXXX SSSSyyyysssstttteeeemmmmXXXXmmmmVVVVSSSSiiiimmmmpppplllleeeeSSSSppppiiiinnnnBBBBooooxxxx((((lllliiiibbbbrrrraaaarrrryyyy ccccaaaallllllll)))) XXXXmmmmNNNNmmmmaaaappppppppeeeeddddWWWWhhhheeeennnnMMMMaaaannnnaaaaggggeeeedddd XXXXmmmmCCCCMMMMaaaappppppppeeeeddddWWWWhhhheeeennnnMMMMaaaannnnaaaaggggeeeedddd BBBBoooooooolllleeeeaaaannnn True CSG XXXXmmmmNNNNssssccccrrrreeeeeeeennnn XXXXmmmmCCCCSSSSccccrrrreeeeeeeennnn SSSSccccrrrreeeeeeeennnn **** dynamic CG XXXXmmmmNNNNsssseeeennnnssssiiiittttiiiivvvveeee XXXXmmmmCCCCSSSSeeeennnnssssiiiittttiiiivvvveeee BBBBoooooooolllleeeeaaaannnn True CSG XXXXmmmmNNNNttttrrrraaaannnnssssllllaaaattttiiiioooonnnnssss XXXXmmmmCCCCTTTTrrrraaaannnnssssllllaaaattttiiiioooonnnnssss XXXXttttTTTTrrrraaaannnnssssllllaaaattttiiiioooonnnnssss dynamic CSG XXXXmmmmNNNNwwwwiiiiddddtttthhhh XXXXmmmmCCCCWWWWiiiiddddtttthhhh DDDDiiiimmmmeeeennnnssssiiiioooonnnn dynamic CSG XXXXmmmmNNNNxxxx XXXXmmmmCCCCPPPPoooossssiiiittttiiiioooonnnn PPPPoooossssiiiittttiiiioooonnnn 0 CSG XXXXmmmmNNNNyyyy XXXXmmmmCCCCPPPPoooossssiiiittttiiiioooonnnn PPPPoooossssiiiittttiiiioooonnnn 0 CSG CCCCaaaallllllllbbbbaaaacccckkkk IIIInnnnffffoooorrrrmmmmaaaattttiiiioooonnnn A pointer to the following structure is passed to each XmSimpleSpinBox callback: typedef struct { int _r_e_a_s_o_n; XEvent *_e_v_e_n_t; Widget _w_i_d_g_e_t; Boolean _d_o_i_t; int _p_o_s_i_t_i_o_n; XmString _v_a_l_u_e; Boolean _c_r_o_s_s_e_d__b_o_u_n_d_a_r_y; } XmSimpleSpinBoxCallbackStruct; The _r_e_a_s_o_n argument indicates why the callback was invoked. There are three possible reasons for this callback to be issued. The reason is XXXXmmmmCCCCRRRR____OOOOKKKKwhen this is the first call to the callback at the beginning of a spin or if it is a single activation of the spin arrows. If the XmSimpleSpinBox is in the process of being continuously spun, then the reason will be XXXXmmmmCCCCRRRR____SSSSPPPPIIIINNNN____NNNNEEEEXXXXTTTT or XXXXmmmmCCCCRRRR____SSSSPPPPIIIINNNN____PPPPRRRRIIIIOOOORRRR, depending on the arrow that is spinning. The _e_v_e_n_t argument points to the XXXXEEEEvvvveeeennnntttt that triggered the callback. It can be NNNNUUUULLLLLLLL when the XmSimpleSpinBox is continuously spinning. The _w_i_d_g_e_t argument is the widget identifier for the simple spin box widget that has been affected by this callback. The _d_o_i_t argument is set only when the _c_a_l_l__d_a_t_a comes from the XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk. It indicates that the action that caused the callback to be called should be performed. The action is not performed if _d_o_i_t is set to False. The _p_o_s_i_t_i_o_n argument is the new value of the XXXXmmmmNNNNppppoooossssiiiittttiiiioooonnnn resource as a result of the spin. The _v_a_l_u_e argument is the new XXXXmmmmSSSSttttrrrriiiinnnngggg value displayed in the Text widget as a result of the spin. The application must copy this string if it is used beyond the scope of the _c_a_l_l__d_a_t_a structure. The _c_r_o_s_s_e_d__b_o_u_n_d_a_r_y argument is True when the spinbox Page 6 (printed 10/24/98) XXXXmmmmSSSSiiiimmmmpppplllleeeeSSSSppppiiiinnnnBBBBooooxxxx((((lllliiiibbbbrrrraaaarrrryyyy ccccaaaallllUUUUllllNNNN))))IIIIXXXX SSSSyyyysssstttteeeemmmmXXXXmmmmVVVVSSSSiiiimmmmpppplllleeeeSSSSppppiiiinnnnBBBBooooxxxx((((lllliiiibbbbrrrraaaarrrryyyy ccccaaaallllllll)))) cycles. This is the case when a XXXXmmmmNNNNssssppppiiiinnnnBBBBooooxxxxCCCChhhhiiiillllddddTTTTyyyyppppeeee of XXXXmmmmSSSSTTTTRRRRIIIINNNNGGGG wraps from the first item to the last or the last item to the first. In the case of the XXXXmmmmNNNNssssppppiiiinnnnBBBBooooxxxxCCCChhhhiiiillllddddTTTTyyyyppppeeee of XXXXmmmmNNNNUUUUMMMMEEEERRRRIIIICCCC, the boundary is crossed when the XmSimpleSpinBox cycles from the maximum value to the minimum or vice versa. EEEERRRRRRRROOOORRRRSSSS////WWWWAAAARRRRNNNNIIIINNNNGGGGSSSS The toolkit will display a warning if the application tries to set the value of the XXXXmmmmNNNNtttteeeexxxxttttFFFFiiiieeeelllldddd resource, which is read-only (marked G in the resource table). SSSSEEEEEEEE AAAALLLLSSSSOOOO XXXXmmmmSSSSppppiiiinnnnBBBBooooxxxx(3), XXXXmmmmCCCCrrrreeeeaaaatttteeeeSSSSppppiiiinnnnBBBBooooxxxx(3), XXXXmmmmSSSSiiiimmmmpppplllleeeeSSSSppppiiiinnnnBBBBooooxxxxAAAAddddddddIIIItttteeeemmmm(3), XXXXmmmmSSSSiiiimmmmpppplllleeeeSSSSppppiiiinnnnBBBBooooxxxxDDDDeeeelllleeeetttteeeePPPPoooossss(3), XXXXmmmmSSSSiiiimmmmpppplllleeeeSSSSppppiiiinnnnBBBBooooxxxxSSSSeeeettttIIIItttteeeemmmm(3), CCCCoooommmmppppoooossssiiiitttteeee(3), CCCCoooorrrreeee(3), XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr(3), XXXXmmmmTTTTeeeexxxxtttt(3), XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd(3), XXXXttttGGGGeeeettttVVVVaaaalllluuuueeeessss(3), XXXXttttSSSSeeeettttVVVVaaaalllluuuueeeessss(3) XXXXmmmmSSSSiiiimmmmpppplllleeeeSSSSppppiiiinnnnBBBBooooxxxxSSSSeeeettttIIIItttteeeemmmm(3); CCCCoooommmmppppoooossssiiiitttteeee, CCCCoooorrrreeee, XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr, XXXXmmmmTTTTeeeexxxxtttt, XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd, in the ; XXXXttttGGGGeeeettttVVVVaaaalllluuuueeeessss, XXXXttttSSSSeeeettttVVVVaaaalllluuuueeeessss in the CAE Specification, Window Management: X Toolkit Intrinsics. Page 7 (printed 10/24/98)